home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / mail / sendmail.8.8.4.tar.gz / sendmail.8.8.4.tar / sendmail-8.8.4 / READ_ME < prev    next >
Text File  |  1996-09-24  |  11KB  |  299 lines
  1. /*-
  2.  *    @(#)READ_ME    8.29 (Berkeley) 9/24/96
  3.  */
  4.  
  5.             SENDMAIL RELEASE 8
  6.  
  7. This directory has the latest sendmail software from Berkeley.  See
  8. doc/changes/changes.me for a summary of changes since 5.67.
  9.  
  10. Report any bugs to sendmail-bugs@sendmail.ORG
  11.  
  12. There is a web site at http://WWW.Sendmail.ORG -- see that site for
  13. the latest updates.
  14.  
  15. ******************************************************************
  16. **  DO NOT USE MAKE to compile sendmail.  Instead, cd src and    **
  17. **  use the "makesendmail" shell script.  On many environments    **
  18. **  this will do everything for you, no fuss, no muss.  See    **
  19. **  src/READ_ME for more details of compilation.  See cf/README    **
  20. **  for details about building a runtime configuration file.    **
  21. ******************************************************************
  22.  
  23.  
  24. +--------------+
  25. | MANUAL PAGES |
  26. +--------------+
  27.  
  28. The sendmail manual pages use contemporary Berkeley troff macros.  If
  29. your system does not process these manual pages, you can pick up the
  30. new macros in a BSD Net/2 FTP site (e.g.  on FTP.UU.NET, the files
  31. /systems/unix/bsd-sources/share/tmac/me/strip.sed and
  32. /systems/unix/bsd-sources/share/tmac/*).
  33.  
  34. The strip.sed file is only used in installation.
  35.  
  36. After installation, edit tmac.doc and tmac.andoc to reflect the
  37. installation path of the tmac files.  Those files contain pointers to
  38. /usr/share/tmac/, and those pointers are not changed by the `make
  39. install` process.  There's also a bug in those files -- make the
  40. following patch:
  41.  
  42. *** tmac.an~    Tue Jul 12 14:29:09 1994
  43. --- tmac.an     Fri Jul 15 13:17:54 1994
  44. ***************
  45. *** 50,55 ****
  46.   .de TH
  47.   .rn TH xX
  48.   .so /usr/share/lib/tmac/tmac.an.old
  49. ! .TH \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
  50.   .rm xX
  51.   ..
  52. --- 50,55 ----
  53.   .de TH
  54.   .rn TH xX
  55.   .so /usr/share/lib/tmac/tmac.an.old
  56. ! .TH "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8"
  57.   .rm xX
  58.   ..
  59.  
  60. Rename the existing tmac.an to be tmac.an.old, and rename tmac.andoc
  61. to be tmac.an.
  62.  
  63. tmac.an will choose between tmac.an.old, your old macros, or tmac.doc,
  64. which are the new macros, so that both the new man pages and the
  65. existing man pages will be translated properly.
  66.  
  67. I'm also told that the groff distribution from MIT has a tmac.doc
  68. macro set that is compatible with these macros.
  69.  
  70.  
  71. +-----------------------+
  72. | RELATED DOCUMENTATION |
  73. +-----------------------+
  74.  
  75. There are other files you should read.  Rooted in this directory are:
  76.  
  77.   CHANGES-R5-R8
  78.     Describes changes between Release 5 and Release 8 of sendmail.
  79.     There are some things that may behave somewhat differently.
  80.     For example, the rules governing when :include: files will
  81.     be read have been tightened up for security reasons.
  82.   FAQ
  83.     Answers to Frequently Asked Questions.
  84.   KNOWNBUGS
  85.     Known bugs in the current release.  I try to keep this up
  86.     to date -- get the latest version from FTP.CS.Berkeley.EDU
  87.     in /ucb/sendmail/KNOWNBUGS.
  88.   RELEASE_NOTES
  89.     A detailed description of the changes in each version.  This
  90.     is quite long, but informative.
  91.   src/READ_ME
  92.     Details on compiling and installing sendmail.
  93.   cf/README
  94.     Details on configuring sendmail.
  95.   doc/op/op.me
  96.     The sendmail Installation & Operations Guide.  Be warned: if
  97.     you are running this off on SunOS or some other system with an
  98.     old version of -me, you need to add the following macro to the
  99.     macros:
  100.  
  101.         .de sm
  102.         \s-1\\$1\\s0\\$2
  103.         ..
  104.  
  105.     This sets a word in a smaller pointsize.
  106.  
  107.  
  108. +--------------+
  109. | RELATED RFCS |
  110. +--------------+
  111.  
  112. There are several related RFCs that you may wish to read -- they are
  113. available via anonymous FTP to several sites, including nic.ddn.mil
  114. (directory rfc), ftp.nisc.sri.com (rfc), nis.nsf.net (RFC),
  115. nisc.jvnc.net (rfc), venera.isi.edu (in-notes), and wuarchive.wustl.edu
  116. (info/rfc).  They can also be retrieved via electronic mail by sending
  117. email to one of:
  118.  
  119.     mail-server@nisc.sri.com
  120.         Put "send rfcNNN" in message body
  121.     nis-info@nis.nsf.net
  122.         Put "send RFCnnn.TXT-1" in message body
  123.     sendrfc@jvnc.net
  124.         Put "RFCnnn" as Subject: line
  125.  
  126. Important RFCs for electronic mail are:
  127.  
  128.     RFC821    SMTP protocol
  129.     RFC822    Mail header format
  130.     RFC974    MX routing
  131.     RFC976    UUCP mail format
  132.     RFC1123    Host requirements (modifies 821, 822, and 974)
  133.     RFC1413    Identification server
  134.     RFC1869    SMTP Service Extensions (ESMTP spec)
  135.     RFC1652    SMTP Service Extension for 8bit-MIMEtransport
  136.     RFC1870    SMTP Service Extension for Message Size Declaration
  137.     RFC1521    MIME: Multipurpose Internet Mail Extensions
  138.     RFC1344    Implications of MIME for Internet Mail Gateways
  139.     RFC1428    Transition of Internet Mail from Just-Send-8 to
  140.         8-bit SMTP/MIME
  141.     RFC1891    SMTP Service Extension for Delivery Status Notifications
  142.     RFC1892    Multipart/Report Content Type for the Reporting of
  143.         Mail System Administrative Messages
  144.     RFC1893    Enhanced Mail System Status Codes
  145.     RFC1894    An Extensible Message Format for Delivery Status
  146.         Notifications
  147.     RFC1985    SMTP Service Extension for Remote Message Queue Starting
  148.  
  149. Other standards that may be of interest (but which are less directly
  150. relevant to sendmail) are:
  151.  
  152.     RFC987    Mapping between RFC822 and X.400
  153.     RFC1049    Content-Type header field (extension to RFC822)
  154.  
  155. Warning to AIX users: this version of sendmail does not implement
  156. MB, MR, or MG DNS resource records, as defined (as experiments) in
  157. RFC1035.
  158.  
  159.  
  160. +-------------------+
  161. | DATABASE ROUTINES |
  162. +-------------------+
  163.  
  164. IF YOU WANT TO RUN THE NEW BERKELEY DB SOFTWARE:  ****  DO NOT  ****
  165. use the version that was on the Net2 tape -- it has a number of
  166. nefarious bugs that were bad enough when I got them; you shouldn't have
  167. to go through the same thing.  Instead, get a new version via public
  168. FTP from ftp.CS.Berkeley.EDU, file ucb/4bsd/db.tar.Z.  This software
  169. is highly recommended; it gets rid of several stupid limits, it's much
  170. faster, and the interface is nicer to animals and plants.  You will
  171. also probably find that you have to add -I/where/you/put/db/include
  172. to the sendmail makefile to get db.h to work properly.
  173.  
  174. Be sure you remove ndbm.h and ndbm.o from the db distribution.  These
  175. will cause problems with sendmail because sendmail already understands
  176. about NEWDB and NDBM coexisting.
  177.  
  178.  
  179. +--------------------+
  180. | HOST NAME SERVICES |
  181. +--------------------+
  182.  
  183. If you are using NIS or /etc/hosts, it is critical that you
  184. list the long (fully qualified) name somewhere (preferably first) in
  185. the /etc/hosts file used to build the NIS database.  For example, the
  186. line should read
  187.  
  188.     128.32.149.68   mastodon.CS.Berkeley.EDU mastodon
  189.  
  190. **** NOT ****
  191.  
  192.     128.32.149.68   mastodon
  193.  
  194. If you do not include the long name, sendmail will complain loudly
  195. about ``unable to qualify my own domain name (mastodon) -- using
  196. short name'' and conclude that your canonical name is the short
  197. version and use that in messages.  The name "mastodon" doesn't mean
  198. much outside of Berkeley, and so this creates incorrect and unreplyable
  199. messages.
  200.  
  201.  
  202. +-------------+
  203. | USE WITH MH |
  204. +-------------+
  205.  
  206. This version of sendmail notices and reports certain kinds of SMTP
  207. protocol violations that were ignored by older versions.  If you
  208. are running MH you may wish to install the patch in contrib/mh.patch
  209. that will prevent these warning reports.  This patch also works
  210. with the old version of sendmail, so it's safe to go ahead and
  211. install it.
  212.  
  213.  
  214. +----------------+
  215. | USE WITH IDENT |
  216. +----------------+
  217.  
  218. Sendmail 8 supports the IDENT protocol, as defined by RFC 1413.
  219. No ident server is included with this distribution.  I have found
  220. copies available on:
  221.  
  222.   ftp.lysator.liu.se        /pub/ident/servers
  223.   romulus.ucs.uoknor.edu    /networking/ident/servers
  224.   ftp.cyf-kr.edu.pl        /agh/uciagh/network/ident
  225.  
  226. If you want to run an IDENT server, I suggest getting a copy from
  227. one of those sites.  Versions are available for several different
  228. systems, including Apollo, BSD, NeXT, AIX, TOPS20, and VMS.
  229.  
  230.  
  231. +-----------+
  232. | MAKEFILES |
  233. +-----------+
  234.  
  235. The Makefiles in this release use the new Berkeley "make" that is
  236. available in BSD Net/2 and 4.4BSD.  If you are using this version
  237. of make, you may notice one or two places where the Makefile includes
  238. "../../Makefile.inc".  This file is not included with the sendmail
  239. distribution because it's not part of sendmail.  However, it is,
  240. in toto:
  241.  
  242.     #    @(#)Makefile.inc    8.1 (Berkeley) 6/6/93
  243.  
  244.     BINDIR?=    /usr/sbin
  245.  
  246. The other directories should all have Makefile.dist files that work
  247. on the old make, albeit without all the niceties included.
  248.  
  249. You can also get a new Berkeley make from the Net2 release (available
  250. on many public FTP archives).  This version should also interpret old
  251. Makefiles, so you could drop it in as your default make.
  252.  
  253. For more details, see src/READ_ME.
  254.  
  255.  
  256. +---------------------+
  257. | DIRECTORY STRUCTURE |
  258. +---------------------+
  259.  
  260. The structure of this directory tree is:
  261.  
  262. cf        Source for Berkeley configuration files.  These are
  263.         different than what you've seen before.  They are a
  264.         fairly dramatic rewrite, requiring the new sendmail
  265.         (since they use new features).
  266. contrib        Some contributed tools to help with sendmail.  THESE
  267.         ARE NOT SUPPORTED by Berkeley -- contact the original
  268.         authors if you have problems.  (This directory is not
  269.         on the 4.4BSD tape.)
  270. doc        Documentation.  If you are getting source, read
  271.         op.me -- it's long, but worth it.
  272. mail.local    The source for the local delivery agent used for 4.4BSD.
  273.         THIS IS NOT PART OF SENDMAIL! and may not compile
  274.         everywhere, since it depends on some 4.4-isms.  Warning:
  275.         it does mailbox locking differently than other systems.
  276. mailstats    Statistics printing program.  It has the pathname of
  277.         sendmail.st compiled in, so if you've changed that,
  278.         beware.  This isn't all that useful.
  279. makemap        A program that creates the keyed maps used by the $( ... $)
  280.         construct in sendmail.  It is primitive but effective.
  281.         It takes a very simple input format, so you will probably
  282.         expect to preprocess must human-convenient formats
  283.         using sed scripts before this program will like them.
  284.         But it should be functionally complete.
  285. praliases    A program to print the DBM or NEWDB version of the
  286.         aliases file.
  287. rmail        Source for rmail(8).  This is used as a delivery
  288.         agent for for UUCP, and could presumably be used by
  289.         other non-socket oriented mailers.  Older versions of
  290.         rmail are probably deficient.  RMAIL IS NOT PART OF
  291.         SENDMAIL!!!  The 4.4BSD source is included for you to
  292.         look at or try to port to your system.  I know it doesn't
  293.         compile on {SunOS, HP-UX, OSF/1, other} (pick one).
  294. smrsh        The "sendmail restricted shell", which can be used as
  295.         a replacement for /bin/sh in the prog mailer to provide
  296.         increased security control.  NOT PART OF SENDMAIL!
  297. src        Source for the sendmail program itself.
  298. test        Some test scripts (currently only for compilation aids).
  299.